home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / programm.ing / rcs5ap1b.lzh / RLOG.1LP < prev    next >
Encoding:
Text File  |  1991-01-30  |  5.9 KB  |  199 lines
  1.  
  2.  
  3.  
  4. RLOG(1)                Programmer's Manual                RLOG(1)
  5.  
  6.  
  7.  
  8. NAME
  9.      rlog - print log messages and other information about RCS
  10.      files
  11.  
  12. SYNOPSIS
  13.      rlog [ _✓o_✓p_✓t_✓i_✓o_✓n_✓s ] _✓f_✓i_✓l_✓e ...
  14.  
  15. DESCRIPTION
  16.      rlog prints information about RCS files.  File names ending
  17.      in ,v denote RCS files; all others denote working files.  If
  18.      a working file is given, rlog tries to find the correspond-
  19.      ing RCS file first in an RCS subdirectory and then in the
  20.      working file's directory, as explained in co(1).
  21.  
  22.      rlog prints the following information for each RCS file: RCS
  23.      file name, working file name, head (i.e., the number of the
  24.      latest revision on the trunk), default branch, access list,
  25.      locks, symbolic names, suffix, total number of revisions,
  26.      number of revisions selected for printing, and descriptive
  27.      text.  This is followed by entries for the selected revi-
  28.      sions in reverse chronological order for each branch.  For
  29.      each revision, rlog prints revision number, author,
  30.      date/time, state, number of lines added/deleted (with
  31.      respect to the previous revision), locker of the revision
  32.      (if any), and log message.  All times are displayed in GMT.
  33.      Without options, rlog prints complete information.  The
  34.      options below restrict this output.
  35.  
  36.      -L  Ignore RCS files that have no locks set.  This is con-
  37.          venient in combination with -h, -l, and -R.
  38.  
  39.      -R  Print only the name of the RCS file.  This is convenient
  40.          for translating a working file name into an RCS file
  41.          name.
  42.  
  43.      -h  Print only the RCS file name, working file name, head,
  44.          default branch, access list, locks, symbolic names, and
  45.          suffix.
  46.  
  47.      -t  Print the same as -h, plus the descriptive text.
  48.  
  49.      -b  Print information about the revisions on the default
  50.          branch, normally the highest branch on the trunk.
  51.  
  52.      -d_✓d_✓a_✓t_✓e_✓s
  53.          Print information about revisions with a checkin
  54.          date/time in the ranges given by the semicolon-separated
  55.          list of _✓d_✓a_✓t_✓e_✓s.  A range of the form _✓d_✓1<_✓d_✓2 or _✓d_✓2>_✓d_✓1
  56.          selects the revisions that were deposited between _✓d_✓1 and
  57.          _✓d_✓2 inclusive.  A range of the form <_✓d or _✓d> selects all
  58.          revisions dated _✓d or earlier.  A range of the form _✓d< or
  59.          >_✓d selects all revisions dated _✓d or later.  A range of
  60.  
  61.  
  62.  
  63. Printed 1/29/91            1990/08/22                           1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. RLOG(1)                Programmer's Manual                RLOG(1)
  71.  
  72.  
  73.  
  74.          the form _✓d selects the single, latest revision dated _✓d
  75.          or earlier.  The date/time strings _✓d, _✓d_✓1, and _✓d_✓2 are in
  76.          the free format explained in co(1).  Quoting is normally
  77.          necessary, especially for < and >.  Note that the
  78.          separator is a semicolon.
  79.  
  80.      -l[_✓l_✓o_✓c_✓k_✓e_✓r_✓s]
  81.          Print information about locked revisions only.  In addi-
  82.          tion, if the comma-separated list _✓l_✓o_✓c_✓k_✓e_✓r_✓s of login names
  83.          is given, ignore all locks other than those held by the
  84.          _✓l_✓o_✓c_✓k_✓e_✓r_✓s.  For example, rlog -L -R -lwft RCS/*,v prints
  85.          the name of RCS files locked by the user wft.
  86.  
  87.      -r_✓r_✓e_✓v_✓i_✓s_✓i_✓o_✓n_✓s
  88.          prints information about revisions given in the comma-
  89.          separated list _✓r_✓e_✓v_✓i_✓s_✓i_✓o_✓n_✓s of revisions and ranges.  A
  90.          range _✓r_✓e_✓v_✓1-_✓r_✓e_✓v_✓2 means revisions _✓r_✓e_✓v_✓1 to _✓r_✓e_✓v_✓2 on the same
  91.          branch, -_✓r_✓e_✓v means revisions from the beginning of the
  92.          branch up to and including _✓r_✓e_✓v, and _✓r_✓e_✓v- means revisions
  93.          starting with _✓r_✓e_✓v to the end of the branch containing
  94.          _✓r_✓e_✓v.  An argument that is a branch means all revisions
  95.          on that branch.  A range of branches means all revisions
  96.          on the branches in that range.
  97.  
  98.      -s_✓s_✓t_✓a_✓t_✓e_✓s
  99.          prints information about revisions whose state attri-
  100.          butes match one of the states given in the comma-
  101.          separated list _✓s_✓t_✓a_✓t_✓e_✓s.
  102.  
  103.      -w[_✓l_✓o_✓g_✓i_✓n_✓s]
  104.          prints information about revisions checked in by users
  105.          with login names appearing in the comma-separated list
  106.          _✓l_✓o_✓g_✓i_✓n_✓s.  If _✓l_✓o_✓g_✓i_✓n_✓s is omitted, the user's login is
  107.          assumed.
  108.  
  109.      -V_✓n Emulate RCS version _✓n when generating logs.  See co(1)
  110.          for more.
  111.  
  112.      rlog prints the intersection of the revisions selected with
  113.      the options -d, -l, -s, and -w, intersected with the union
  114.      of the revisions selected by -b and -r.
  115.  
  116. EXAMPLES
  117.          rlog  -L  -R  RCS/*,v
  118.          rlog  -L  -h  RCS/*,v
  119.          rlog  -L  -l  RCS/*,v
  120.          rlog  RCS/*,v
  121.  
  122.      The first command prints the names of all RCS files in the
  123.      subdirectory RCS that have locks.  The second command prints
  124.      the headers of those files, and the third prints the headers
  125.      plus the log messages of the locked revisions.  The last
  126.  
  127.  
  128.  
  129. Printed 1/29/91            1990/08/22                           2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. RLOG(1)                Programmer's Manual                RLOG(1)
  137.  
  138.  
  139.  
  140.      command prints complete information.
  141.  
  142. DIAGNOSTICS
  143.      The exit status is zero if and only if all operations were
  144.      successful.
  145.  
  146. IDENTIFICATION
  147.      Author: Walter F. Tichy.
  148.      Revision Number: 5.0; Release Date: 1990/08/22.
  149.      Copyright c 1982, 1988, 1989 by Walter F. Tichy.
  150.      Copyright c 1990 by Paul Eggert.
  151.  
  152. SEE ALSO
  153.      ci(1), co(1), ident(1), rcs(1), rcsdiff(1), rcsintro(1),
  154.      rcsmerge(1), rcsfile(5)
  155.      Walter F. Tichy, RCS--A System for Version Control,
  156.      _✓S_✓o_✓f_✓t_✓w_✓a_✓r_✓e--_✓P_✓r_✓a_✓c_✓t_✓i_✓c_✓e & _✓E_✓x_✓p_✓e_✓r_✓i_✓e_✓n_✓c_✓e 15, 7 (July 1985), 637-654.
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195. Printed 1/29/91            1990/08/22                           3
  196.  
  197.  
  198.  
  199.